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Subject: New Strategy for Conversion of Terminal Output 
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In tty_write as currently implemented* each character of 
user- supp I i ed data is individually examined and looked up in 
various tables to determine what should d e placed in output 
ouffers to be sent to the 355 and thence to the terminal. Even in 
"rauo" mode* where the user's data is passed on with no 
conversion* each character is nonetheless copied individually* 
with the count of characters being incrementeo one at a time. 
When either the end of the user's data is reacned or the maximum 
number of ring-zero buffers the user is allowed to have is 
filled* conversion stops and* if appropriate* the data so far 
converted is shipped to the 355. 



This mechanism has the obvious advantage of simplicity: it 
is particularly easy to keep track of how many of tne user's 
characters have been transmitted and how much buffer space is 
being used. However* this aavantage is more than offset by the 
loss of efficiency in processing characters one at a time. In 
addition/ the tables used for the conversion are kept/ by 
terminal type* in a ring zero data base (tty.ctl)* and pointers 



Multics Project internal working documentation. Not to be 
reproduced or distributed outside the Multics Project. 



MULTICS TECHNICAL BULLETIN MTB - 234 



page 2 



to them are derived by tty_ write every time it is called. In this 
setuo/ no method is avai table for the user to substitute his/her 
own translation tables. Still worse/ the same table is used both 
for determining whether a character is "special" (requires 
escaping or the addition of delays) and for converting from ASCII 
to some "foreign" code (such as EBCDIC); tnis situation makes it 
virtually impossible to avoid' looking up and doing something 
about every character input to tty_write. 



The new design is predicated on the assumption that the vast 
majority of characters sent to the user 1 s terminal are 
"uninteresting" -- i. e.* they are to be shipped as they are* 
they ao not require delays* and each one advances the carriage by 
one position. A block of such characters can clearly be copied 
into tty_buf all at once with a single EIS instruction* or at 
least in buffer-sized chunks. The only problem is identifying the 
limits of such a block* and making the necessary additions and 
substitutions when an "interesting" character is encountered. 
Wholesale translation (e. g.* ASCII to EBCDIC) is a separate 
issue* and can also be dealt with economically using EIS. 



The functions of tty_write can be logically divided into 
four phases: 



1 • P££iiEiua£X_LQuY.££S > iQO (specifically the translation of 
of lowercase letters to uppercase for a Teletype model 33 
or terminals in "capo" mode; 

2. FacmatLioa ' i.e.* substitution of escape sequences* 
insertion of new-line characters in long lines* 
canonicalization and op t i m i z i a t i on of white space* etc.; 

-5. Ir.aO£LldtiQQ' as from ASCII to EBCDIC; 

h • £y 1 1 g£«aliQ£a iiQn_ancj_c.Qi3^ing of characters into buffers 
in tty_buf* whence they will be read by the 355. 

In the current tty_ write* these four phases are executed more or 
less simultaneously on each character; in particular* phases 2 
and 3 (formatting and translation) are not distinguished* and are 
driven oy the same table. The new design executes each phase over 
the entire input string (or as much of it as will be transmitted 
at once) before passing on to the next phase. In most cases* of 
course* either phase 1 or phase 3 or both can be omitted; in 
"rawo" mode* tty_write can and does proceed directly to phase 4. 
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Each phase is provided with an "input pointer" to the 
Location where the previous phase left the data in its latest 
form. This pointer points either to the user's original input or 
to either of two Duffers in 1 1 y _ write* s automatic storage* as 
des cr i oed later. 



The only serious disadvantage to this scheme is that the 
determination of how many of the user's characters are actually 
to be shipped must be made in advance of conversion/ and this 
determination must attempt to take into account the probability 
that the final output will contain more characters than the user 
supplied. There is no ideal solution to this problem* but one has 
been developed which ensures that the program will behave 
correctly in all cases/ and in general will have the same effect 
as today (in terms of the number of calls required to output a 
given string/ the pressure put on tty_buf/ etc.). This solution 
is descrioed later in this document. 



Extensive use has been made in this design of three EIS 
instruction; : move with translation (mvt)/ test character and 
translate (tct)/ and scan with mask (scm). PL/I builtin functions 
such as translate do not completely meet our requirements/ 
therefore an ALM subroutine/ tty_util_/ is supplied/ containing 
entry points to perform the necessary functions. 



The remaining sections of this MTB contain the following: 



1. A more detailed description of the four, phases of 
conversion mentioned above; 

2. A discussion of space allocation and character counting; 

3. A description of the data structures used for conversion 
and translation/ as well as an indication of the proposed 
method for allowing the user to substitute his own 
versions of the relevant tables/ 

A. A module description of tty_util_. 
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Certain terminals require uppercase-only output/ similarly/ 
a user can specify (by entering "capo" mode) that all lowercase 
letters are to be converted to uppercase for output. These cases 
are treated identically by tty_write: an mvt (move with 
translation) instruction is used to copy the user's data into an 
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automatic buffer/ using a translation table which substitutes 
uppercase ASCII for lowercase. If the user is in "edited" mode/ 
this is all that needs to be done for this phase; if not/ 
however/ each letter which was originally uppercase must be 
preceded by an escape character ("\"). Therefore/ in ""edited" 
mode/ the translation table also replaces each uppercase letter 
with the same character with its high-order bit (the "400(8)" 
bit) turned on. After the mvt is completed/ an scrn (scan with 
mask) instruction is executed to find the first character with 
the "400" bit on; if one is found/ all characters to the left of 
it are copied to a second internal buffer/ an escape is inserted 
after the copied characters/ and the high-order bit of the found 
character is turned off. The scrn is repeated on the remainder of 
the characters in the first buffer until all characters have been 
copiec to the second buffer with escapes inserted as neeced. If 
no characters with the high-order bit on are found in the entire 
string/ no copying is done. 
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carriage motion characters before the next graphic to be 
inserted* or discarded if the next character involves vertical 
carriage motion. This process is repeated until all the source 
characters are used up. If it happens that the first call to 
tty_util_$find_char returns an indicator of zero and has used up 
the entire source string/ no characters are moved by this phase. 



The subroutine t t y_ ut i I _$ f i n d_ c h ar uses a tct instruction to 
find interesting characters* but it must do other things as well. 
In the first place* for the instruction to notice tnat a 
character has either or both of its high-order pits on* a table 
of 512 entries would be needed* of which 384 would be identical; 
secondly* a single Plank between two printing graphics is not 
interesting to tty_write* but two or more consecutive Planks are 
considered "white space*" as is any combination of blank and one 
or more other carriage movement characters. To cover the first 
case* 1 1 y_u t i l_ S f i nd. c ha r performs two scm instructions to find 
the earliest character (if any) which does not fit in seven oits. 
for the case of multiple blanks* it is clearly undesirable to 
nave a non-zero indicator in the tct table for blank/ ana thus 
force the tct to stop on all blanks* test to see if the next 
cnaracter is a blank* and then proceed if it is not. Instead* the 
tct is preceded by an scd (scan character double) instruction 
which looks for two successive blanks. Tne tally and pointer 
returned to tty_ write reflect the earliest point in the source 
string at which either the tct* the scd* or either of the two 
scm's found anything interesting. 



It will be seen from the module description of 
t t y_u t i I _S f i nd_ c ha r later in this MTB that a "white space" 
indicator implies that the pointer points to the beginning of a 
clock of white space* which tty_write then examines until it 
finds the end of the block. Therefore if the first interesting 
character found by tt y_ut i l_$f i nd.char is a carriage movement 
character* it must check to see if the immediately preceding 
character is a blank, in which case it returns a pointer to the 
blank rather than the character following it. 



Another responsibility of the formatting phase is the 
counting of output lines and watching for full pages. In the old 
tty. write* page length is respected only for ARDS-like screen 
terminals; when the maximum line count is reached* t ty.wri te 
stops processing characters and sets a flag in the fixed control 
block (fctl) associated with the terminal. This flag gets 
transmitted to the 355* which then understands that* when the 
output is completed* it must- not ask for more output for that 
channel until it receives a form-feed character as input. The new 
design extenas the concept of page length to all terminals 
capable of receiving or transmitting a form -feed* and removes all 
knowledge of the end-of-page condition from the 355. In addition* 
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tty_write no longer stops processing characters when the line 
count reaches maximum; instead/ the formatting phase inserts a 
warning string (such as "EQP") and a sentinel character at the 
end of the page* and the copying phase (see below) later removes 
each sentinel and turns on a flag in the buffer that ends the 
page. When dn355 (the program that actually sends the buffers to 
the 355) sees this flag/ it ceases transmission* and qqw sets the 
flag in the fctl block. When it receives input for a channel with 
the end-of-page flag on/ it scans this input for a form-feed; if 
it finds one* it replaces it with a PAD character (177(8))/ turns 
off the fctl flag* and starts up output for the channel again. 
(1 ) 



Iran s i§ t iqn 



The translation phase is very similar to tne preliminary 
conversion phase described earlier. An mvt instruction is used to 
copy the entire string from wherever it was left by the preceding 
phase to an automatic Duffer* translating it from ASCII to the 
appropriate output code in the process. (At present the only 
output codes other than ASCII known to Muttics are EBCDIC and ISM 
Correspondence.) This does not complete the process for a 
terminal which requires case -shift characters (which currently 
includes all terminals for which translation is done); the 
insertion of case-shift characters is done in a similar manner to 
the insertion of escapes before capital letters as described 
under "Preliminary Conversion." The translation table causes the 
high -order bit of each uppercase character to be turned on (in 
tnis context the term uppercase refers not only to capital 
letters out to all characters for which the shift key must be 
depressed while typing) and the "200(8)" bit of each lowercase 
character to be turned on; characters which may be in either case 
(such as space) contain no extra bits. After translation* an scm 
is done to find the first character in the opposite case to the 
one in which the terminal was at the start of the output; all 
characters to tne left of it are copied* an appropriate shift 
character is inserted after the copied characters* and another 
scm is used to find the next change of case. If all the output 
characters are in the same case* no copying is done. Note that it 
is not necessary to turn off the high-order bits of the uppercase 
characters* since these bits will be ignored by the remainder of 
the tty DIM and ultimately thrown away by the 355. 



(1) A mode may be added in future which would allow a user to 
specify that when a page is full tne tty DIM should automatically 
output a form-feed rather than waiting for one to be input. On a 
hard-copy terminal* this mode would probably make more sense than 
the current method. 
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The final phase of tty_write consists of allocating buffers 
in tty_buf and copying the final output into these buffers. A 
buffer in tty_ouf is 1o words long* of which the first contains a 
forward pointer* flags* and a tally; each buffer therefore holds 
up to 60 characters, Thus one buffer is allocated by tty_write 
for every 6 0 characters of final output* and the characters are 
copied in 60-character chunks. If an end-of-page sentinel is 
encountered* the end-of-page flag is turned on in the current 
buffer* and the buffer is not filled past the sentinel. If output 
already processed for the particular channel has not yet been 
sent* a chain of buffers for that channel will already exist; if 
the last buffer in this chain is not full* and does not have its 
end-of-page flag on* it will be filled before further buffers are 
allocated. The newly- allocated buffers' will be threaded onto the 
ci : chain. Finally* if the " s ena_ ou t pu t" flag in the fctl block 
is on* indicating that an 355 and the 355 itself are prep area to 
handle output for the channel/ tty_write calls dn 3 5 5 $ i o _c omma nc 
to cause a mailbox to be sent to the 355 telling it that output 
is on the way . 



SPACE_A^L/0CAT I ON .A ND _£H AR A£T £R.£^y^IXNg 



Because the input string undergoes wholesale modification at 
several points/ it is necessary to decide how ma n y of the user's 
characters to process oef ore actually doing anything. Certain 
constraints whicn exist in the present implementation will be 
retained: no more than a certain fraction of available buffers in 
tty_ouf are to be assigned to a single channel at any time; and 
no output chain of more than a certain number of buffers will be 
ouilt. The particular numbers involved are* for the sake of 
convenience and simplicity* preset system-wide constants. The 
current values/ which appear reasonable* are 1/4 and 16 
respectively; i.e./ no channel is ever assigned more than 1/4 as 
many buffers as are free at the time of assignment* and a maximum 
of 16*6u = 960 characters will be processed by a single call to 
1 1 y_ w r i t e . 



The first determination made by tty_ write* then* is the 
maximum number of buffers the caller is allowed to have/ which 
i s : 

maxbuf = min(16* ( bu f f e r s_ I e f t /4 ) - bu f f ers.ass i jned) 
The number of characters to process may then be expressed as 
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nchars = m i n ( c ha r s_su pp I i ed / maxbuf *c hars.per^buf f er ) 

if the terminal is in "rawo" mode/ this is the number of 
characters that will actually be shipped/ and nothing further 
need be done. In general/ however/ the number of characters 
actua Uy output is somewhat larger than the number supplied; 
meters done at various times show an average growth ratio of 
about 6:5. Accordingly/ for non-raw output/ tty_write will 
multiply nchars as calculated above by 0.6 to allow for growth 
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Am additional consideration arises from the use of internal 
buffers in tty.write. Because of the possibility of more than one 
intermediate copy/ two such buffers are needed/ and rather than 
create two segments so as to allow each Puffer to grow 
essentially without limit/ it was decided to set aside fixed-size 
buffers in tty_write's stack frame. The size chosen for each of 
these buffers is the maximum allowable output chain size/ i. e./ 
960 c harac ter s. 



Clearly growth ratios yreater than 5:4 can and will occur; 
there are pathological cases such as an object or other non-ASCII 
segment hein^ printeu on a 2 74 1 t erm i na I / which involves a growth 
ratio of more than 5:1 ( <uppe r_s h i f t > i < I o we r_ sh i f t > nnn for 
each input character/ plus added new-lines and 4c markers). Thus 
despite precautions we must be prepared for tne possibility that 
in the course of translation or formatting we will run out of 
space in the internal Puffer. When this happens/ the number of 
input characters to be handled is cut in half/ and character 
processing is started over from phase 1. This solution is 
admittedly crude/ but the alternative is to keep track at all 
times of the number of the user's characters which have been 
processed/ which in some cases (particularly the transformation 
of white space) is non-trivial in the new scheme; it seems 
inadvisable to incur this overhead on every call to tty_write in 
order to avoid expense in a rare case. The problem will only 
arise when attempting to p roces s . 768 user characters of which an 
unusually large number have to be escaped; considering that the 
average output message is around 5<J characters/ the overall 
expense of double processing in such a case is not likely to be 
significant. 
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If space in tty_buf is unusually tight* then an abnormal 
character string which is not large enough to overflow the 
internal ouffer space -night nonetheless require the allocation of 
more buffers than are available. If tty_ write fin as that it is 
about to allocate the last buffer* it will take the same action 
as if it were about to overflow one of its internal Duffers* i. 
e.* divide the numoer of input characters in half and start over. 
This circumstance is considered even less probable than the 
overflowing of an internal buffer* if it happens often it is 
probably an indication that tty.buf is too small. 



we coulu* of course* reduce the frequency of overflow events 
still further Dy decreasing the percentage of the theoretical 
maximum number of characters that will actually be processed at 
once; however* this would increase the probability that the 
user's characters could not be handled in a single call* thereby 
requiring users to go blocked for output more often and 
increasing the number of calls to tty^write. The figures used in 
this M T 8 are a preliminary estimate cased on what seems 
reasonable*' they can easily be adjusted if metering shows either 
a high frequency of double processing or an excessive (i.e.* 
greatly increased) number of calls to tty_ write. 



This section describes the tables to be used by tty_ write 
for translation and formatting. Packed pointers to these tables 
will oe kept in the control block ( c t I ) a 1 1 o ca t ed for each line 
when it dials up; the default tables are in tty_ctl on a 
pe r- t ermi na I- type oasis as at present* and pointers to these 
tables are copied from t t y_ c t I into the ctl block the first time 
tty_write is called for any one dialup. 



In a future modification* control operations will be 
provided to allow a user to substitute his/her own version of one 
or more of these tables. Macros (in mexp) may also be provided to 
facilitate the construction of such taoles. This capability* 
however* introduces problems as long as the Answering Service 
does not use the secure (ring 1) message facility rather than 
calling ncs_$tty_write directly. Write calls from the Initializer 
for a terminal using u s e r - su pp I i ed translation tables would 
reference pointers in the user's address space (not the 
Initializer's)/ wnich at oest would result in garbage being 
printed on the user's terminal. (A possible alternative to using 
the message facility is to have the Answering Service call a 
special entry which uses the default tables for the terminal type 
whether the user has supplied tables or not; the output might be 
■garbled* but at least the taoles would De accessible to the 
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Initializer.) 



The header of tty_ctl contains an array/ indexed by terminal 

type/ of relative offsets of default tables- The default table 

contains relative pointers to the conversion tables to be used by 

default for the given terminal type. The format of the default 

table is as follows: 



acl 1 de v i c e_de f au It s aligned based/ 
2 flags u n a I / 

3 shifter bit (1) u n a I / 
3 upper.case.on ly bit CD una 1/ 
3 pad bit (7) una I / 
2 delay_char char CD unaU 
2 upper_case char (D unal/ 
2 lower-case char (D unaU 
2 tct_ offset fixed bin (18)/ 
2 mvt_offset fixed bin (13)/ 
2 spe c i a l_of f se t fixed bin (18)/ 
2 delay.offset (4) fixed bin (18); 



shifter is "1"b if the terminal requires case 

shift characters. 

up permease. only is " 1"b if the terminal handles only 

capital letters. 

/ 

a e lay _ char is the ASCII form of the character used 

for carriage movement delays. 

upper_case is the uppercase shift character. 

louer_case is the lowercase shift character. 

tct.offset- is the relative offset (in tty.ctl) of 

the default table used by 

tty_util_$find_ch<jr for identifying 
"special'* characters. 

n.vt.offset is the relative offset of the table used 

by 1 1 y_ut i l_$m vt for translation/, or 0 
if translation is not required for the 
particular terminal type. 
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spe c i a l_of f se t is the relative offset of the default 

version of the special.char s table 
described below. 

delay_offset is an array of offsets of the 

delay.tables (described below) to be 
used for this terminal type at 110/ 150/ 
300/ and 1200 bps respectively. 



£ 2 £ £ 1 3 1 _ £ h ax 2 £A £ C £ _ la p. 1 e. 

The special characters table is used by the formatting phase 
of tty.wri te. It has the following format: 



del 1 spec i al.chars aligned based/ 
2 cmt (6) aligned/ 

3 count fixed bin (8) unal/ 

3 chars (3) char (1) unal/ 
2 pri nter_on aligned/ 

3 count fixed bin (8) unal/ 

3 chars (3) char (1) unal/ 
2 printer_off aligned/ 

3 count fixed bin (8) unal/ 

3 chars ( 3 ) char (1) unal/ 
2 red_ ri bbon.sh i f t aligned/ 

3 count fixed oin (8) unal/ 

3 cnars (3) char (1) unal/ 
2 o I a c k_ r i boon. sh i f t aligned/ 

3 count fixed bin (8) unal/ 

3 chars (3) char (1) unal/ 
2 end_of_page aligned/ 

3 count fixed bin (8) unal/ 

3 chars (3) char (1) unal/ 
2 es cape.l ength fixed bin/ 

2 not_editea_escapes (10 refer ( es c ape. le ngt h ) ) / 

3 count fixed bin (8) unal/ 

3 chars (3) char (1) unal/ 
2 ed i t ed.escapes (10 refer (escape. length ))# 

3 count fixed bin (8) unal/ 

3 chars (3) char (1) unal; 



Note: In each of the level 2 substructures in this structure 
declaration/ count/ which has a value 0 <= count < = 3/ indicates 
the number of characters in the sequence* the first count 
elements of the chars array is the sequence itself. If count is 
zero/ there is no sequence for the character in question. 
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cmt 



describes the character sequences to be 
used for the six carri age movement 
characters* in this order: new-line* 
carriage return* backspace* horizontal 
tab* vertical tab* form-feed. If count 
is zero* the carriage movement function 
in question is not available on the 
terminal. In this case* the following 
action istaken: 



new-line 



<i n va I i d> 



carriage return 



substitute appropriate 
number of backspaces 



back space 



substitute carriage 
return and appropriate 
number of blanks and/or 
horizontal taps 



hori zont al tab 



substitute appropriate 
number of blanks 



vertical tab* 
form-feed 



i gnore character 



The 



counts 



for carriage reurn and 



backsoace may not both be zero. 



printer_on is the character sequence to be used to 

implement the "printer_on" control 
ope rat i on. 

printer_of f is the character sequence to be usea to 

implement the "p r i n t e r _o f f " control 
operation. 



r ed_r i bbon_-sn i f t 



b I a c k _ r i bb on. sh i ft 



end_o f _pa qe 



is the character 
substituted for a 
character. 

is th 
s ub s t i 
c ha r ac 

is the character s 
to indi cate that 
full. 



sequence to be 
red r i bbon-s h i f t 



e character sequence to be 
t.uted for a black ribbon-shift 
t e r . 

equenci to be printeo 
a page of output is 



escape, I eng tn 



is the number of output escape sequences 
in each of the two escape arrays. 
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not. edited. escapes is an array of escape sequences to be 

substituted for particular characters if 
the terminal is in ""edited" mode. This 

i rrjy i 5 i nHa v or| SCCOfdiriQ tO the 

indicator returned by 

t ty.ut i l.$find. char. 

edi t ed.e sc apes is an array of escape sequences to be 

used in "edited" mode. It is- indexed in 
the same fashion as n o t.ed i t ed_ esc ape s . 



The delay table provides the number of delays to be used in 
conjunction with carriage movement characters. It has the 
following format: 



del 1 delay based aligned/ 1 

2 vert.nl fixed bin* 

2 horz.nl fixed bin* 

2 const.tab fixed bin* 

2 var.tab fixed bin* 

2 backspace fixed bin* 

2 v t f f fixed bin; 



vert.nl is the number of aelay characters to be 

output for all new- lines to allow for 
the line -feed. 

horz.nl is a factor usea to determine the number 

of delays to be added for the carriage 
return portion of a new-line* depending 
on column position. Tne formula for 
calculating the numoer of delay 
characters to be output following a 
n ew- I i ne is: 

ndelays = vert.nl + ( h o r z .n I * c o I u mn ) / 5 1 2 

const.tab is the constant portion of the number of 

delays associated with any horizontal 
taD character. 

var^tab is a factor useu to determine the number 

of additional delays associated with a 
horizontal tab depending on the number 
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of columns traversed. The formula for 
calculating tne number of delays to be 
output following a horizontal tab is: 

ndelays = const_tab + ( va r_ t ab * n_ c o I u mns ) / 5 1 Z 

Lackspace is the number of delays to be output 

followiny a backspace character. If it 
is negative* it is the complement of the 
number of delays to be output with the 
first backspace of a series only (or a 
single backspace). This is for terminals 
such as the TermiNet 300 which need 
delays to allow for hammer recovery in 
case of overstrikes/ but do not require 
delays for the carriage motion 
associated with the backspace itself. 

vt_ft is the number of delays to be output 

following a vertical tab or form- feed. 
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£jame : 1 1 y_ut i I 



The entries in this module are used for translation and 
formatting of typewriter input and output. All of them run in 
tne caller's stack frame/ and take as an argument a pointer to an 
argument structure provided by the caller. 



tntLl : tty.ut i l.Sf ind.char 

This entry uses a tct (test character and translate) 
instruction to search a given string for "interesting" characters 
as defined by a translation table supplied by the caller. 



Uaaje 



declare 1 1 y _ut i I f i n d_ c h a r entry (ptr); 
call t ty_u t i l_ $ f i nd_c ha r (argptr); 



where argptr is a pointer to the structure described 

below. (Input) 



del 1 tct.arg.st ructure based ali gned/ 

2 stringp ptr/ 

2 string I fixed bin/ 

2 tally fixed bin/ 

2 tablep ptr/ 

2 indicator fixed bin/ 

2 workspace (3) fixed bin* 



stringp is a pointer to the string to be tested/ 

if indicator (see below) is 3 or 7/ it 
is updated to point to the first 
"interesting" character in the string; 
otherwise/ it is updated to point to the 
character following the first 

"interesting" character. (Input/Output) 

stringl is the length in Characters of the 

string tc ue tested. If stringl is 
greater than 2000/ only the first 2000 
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characters are tested. stringl is 
decremented by the same number of 
characters as stringp is advanced. If 
the entire string is searched and 
indicator is G* stringl is set to 0. 
( Input /Output ) 

tally is the number of "uninteresting" 

characters passed over by the test. 
( Output) 

tab I ep 



indicator 



i s a 


pointer to an 


ali 


gned 


packed arr 


ay 


of 


123 fixed bin 


(8) 


va I 


ue s to 


be us 


ed 


as a 


translation 


t ab 


le. 


The 


e I em en 


ts 


c or r 


espond to ASCII 


cha 


r a c t e r 


s in t 


he 


nor ma I collating s 


eque 


ncef 


Lilt? V 


a I u e 


0 T 


each 


element 


i s 


c 


e r o 


if j- 


h o 


c or res pond i ng 


c 


h a r a 


f a r* 




i s 


uni nterest i ng* or 


els 


e t n 


e v a I u 


e o t t 


h e 


indicator to De 


r 


e t u r 


n e o 


i f t 


h e 


corresponding cha 


ract 


e r i 


s en co 


unt ere 


d. 


(Input) 












is the result of t 


he s 


earc 


h. It 


may ha 


ve 


t he 


f o I lowi ng va lu 


es : 










o -- 


no spec i al ch 


a r ac 


ters 








1 -- 


new- 1 i ne 












2 -- 


carri age retu 


rn 










3 -- 


"white space/ 


" i 


e 


• t no 


r i i on t 


al 




tab* two 


or 


mor 


e con 


secu t i 


ve 




blanks* or a 


comb 


i na t 


ion of 


one 


or 




more bl anks 


and 


a t a 


b or b 


ack spa 


c e 




character, st 


r i ng 


p i s 


set t 


o po i 


nt 




to the f 


i r st 


ft 


white 


space" 




character. 












4 — 


backspace 












5 


vertical tab 












6 


form- feed 












7 -- 


character requiri 


ng o 


c t a I e 


scape 




8 — 


red ribbon shift 










9 — 


black ribbon 


sh i f 


t 
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other a character requiring a special 

escape sequence. The indicator 
value is the index into the 
escape table of the sequence to 
be used* pi us 1 6. 

orkspace is to be used by t ty.uti I. for temporary 

storage if necessary. 



EoiCX^ tt y_ut i l_$mvt 



This entry is used to translate a character string using an 
/nvt (move with translation) instruction. 



Uiige 

declare t t y _ut i L _$m v t entry (ptr); 
call t ty_ut i l.Sinvt (argptr); 



where 



argptr 



is a pointer to the tnvt^arg.structure 
described below. (Input) 



del 1 mvt_ar g_st ructure based aligned* 
2 stringp ptr* 
2 st n ng I fixed bin* 
2 pad fixed bin* 
2 tablep ptr* 
2 targetp ptr* 
2 workspace (2) fixed Din/ 



St r i n gp 
St r i ng I 
tablep 

targetp 



is a pointer to the character string to 
be translated. (Input) 

is the length in characters of the 
string pointed to oy stringp. (Input) 

is a pointer to an aligned character 
string of length 128 to be used as a 
translation table. (Input) 

is a pointer to the place where the 
translated string is to be placed; it 
must point to a character string of 
length stringl or greater. (Input) 
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workspace is as abo^e. 



foil*: tty_util_$scm 



Tnis entry is used to search a character string for a 
character with one of its two high-order bits on/ using an scm 
(scan with mask) instruction. 



ijs d^e 

declare tty_util_$scm entry (ptr); 
call t t y_u t i l_ $s cm (argptr); 



where argptr points to the scm.arg.structure 

described below- (Input) 



del 1 scm_arg_ structure based aligned/ 
2 string p ptr , 
2 stringt f i xed bin/ 
2 tally fixed bin/ 
2 search_mask bit (2) aligned/ 
2 founds flag bit (1) aligned/ 
2 workspace ( 4 ) fixed bin; 



string p is a pointer to the string to be 

scanned. If the scan succeeds/ it is 

updated to point to the character in 
question. < Input /Output ) 

s t r i n g I is the length of the string pointed to 

oy stringp. It is decremented by as many 
characters as stringp is advanced. 
(Input/Output) 

tally is the number of characters passed over 

during the scan (i. e./ the number of 
characters to the left of the character 
founo/ or the length of the string if no 
character is found). (Output) 

search.mask is M lO M b if the 400(8) bit is to be 

searched for/ or "01"b if the 200(8) bit 
is to be searched for. (Input) 
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found_flaq is set to "1"b if a character with the 

bit specified by search.mask on is 
found; otherwise it is set to "0"b. 
( Output) 



work spac e 



is as above. 



